Skip to content

Interstitial bareground#1577

Draft
glemieux wants to merge 5 commits into
NGEET:mainfrom
glemieux:interstitial_bareground_option
Draft

Interstitial bareground#1577
glemieux wants to merge 5 commits into
NGEET:mainfrom
glemieux:interstitial_bareground_option

Conversation

@glemieux

@glemieux glemieux commented Jun 14, 2026

Copy link
Copy Markdown
Contributor

Changes how FATES handles interstitial bareground

Description:

CLM associated pull request is ESCOMP/CTSM#4094

Collaborators:

@ckoven

Expectation of Answer Changes: Yes

Description of generative AI usage (as necessary)

Checklist

If this is your first time contributing, please read the CONTRIBUTING document.

All checklist items must be checked to enable merging this pull request:

Contributor

  • The in-code documentation has been updated with descriptive comments
  • The documentation has been assessed to determine if updates are necessary
  • Describe use of generative AI (if necessary)

Integrator

  • FATES PASS/FAIL regression tests were run
  • Evaluation of test results for answer changes was performed and results provided
  • FATES-CLM6 Code Freeze: satellite phenology regression tests are b4b

If satellite phenology regressions are not b4b, please hold merge and notify the FATES development team.

Documentation

Test Results:

CTSM (or) E3SM (specify which) test hash-tag:

CTSM (or) E3SM (specify which) baseline hash-tag:

FATES baseline hash-tag:

Test Output:

glemieux added 3 commits June 14, 2026 14:54
This reflects that the output will be a fraction dependent on certain logic having to do with handling bareground
bare_frac_area = (1.0_r8 - local_patch_fraction) * &
(currentPatch%area/AREA)

total_patch_area = total_patch_area + bc_out(s)%canopy_fraction_pa(ifp) + bare_frac_area

@glemieux glemieux Jun 14, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note that this is dead code being removed (total_patch_area). It wasn't being used downstream.

Comment on lines +1449 to +1451
bc_out(s)%z0m_pa(ifp) = EDPftvarcon_inst%z0mr(1) * bc_out(s)%htop_pa(ifp)
bc_out(s)%displa_pa(ifp) = EDPftvarcon_inst%displar(1) * bc_out(s)%htop_pa(ifp)
bc_out(s)%dleaf_pa(ifp) = EDPftvarcon_inst%dleaf(1)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Q: Is this still valid regardless of the inclusion of interstitial bareground or not? Or do we need a different calculation if there truly is no canopy? What do HLM's use for pure bareground in this case?

weight = min(1.0_r8,currentCohort%c_area/currentPatch%total_canopy_area)
weight = min(1.0_r8,currentCohort%c_area/weighting_area)
bc_out(s)%z0m_pa(ifp) = bc_out(s)%z0m_pa(ifp) + &
EDPftvarcon_inst%z0mr(currentCohort%pft) * currentCohort%height * weight

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Q: Does more of this calculation need to change if we are including the interstitial bareground?

@glemieux glemieux force-pushed the interstitial_bareground_option branch from 72d4d2e to 389f7e8 Compare June 26, 2026 23:25
@glemieux glemieux force-pushed the interstitial_bareground_option branch from 389f7e8 to f8dc5ff Compare June 29, 2026 17:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant